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Memorandum MAC - M - 167 
Date: June 30, 1964 


TO: All MAC System Users 

FROM: Arthur L. Samuel 

SUBJECT: A NEW EDITING PROGRAM 


This memorandum describes a new edit routine (currently initiated by the 
command "Resume E") which has been written to circumvent some of the 
more serious difficulties surrounding the use of the present edit command 
when used with moderately large programs. In addition to many safety 
features, the program provides for a special "peek" mode of operation in 
which the user may request a "peek" at any line, and may make character - 
by-character corrections, deletions, and insertions to this line. 

What follows is written in a form suitable for inclusion in a programmer's 
manual. 


EDITS 


EDITS is an editing program designed for the convenient and safe handling 
of large files where it is desirable (1) to be able to have frequent looks at 
the file during the editing process, (2) to make character-by-character 
corrections, and (3) to have input information automatically checked for 
format. There is no limit to the size of file that can be edited other than 
the limit set by the user's track quota. 

Files may be in any of the following formats: FAP, MAD, MADTRN, LISP, 
COMIT, or DATA and they may be in the old expanded form or in the new 
compressed form as described in MAC - M - 157. 
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EDITS creates a set of short disk files (duplicating the original file, 
if one exists). Editing is then done on these split files. Files may- 
be saved in their split form or they may be combined into a new file 
(either in addition to the original file or replacing it). Whenever a 
file is to be updated or replaced, the old file is saved until after the 
new file has been created. In doubtful situations a final approval by 
the user is also required before an old file will be destroyed. 

An understanding of two rather simple conventions is all that is needed 
to start operating the program, these conventions having to do with the 
use of the carriage return alone, and the use of a period after a line 
number. 

The carriage return by itself basically means NO. If the computer 
asks for the name of the file to be edited and you are in doubt as to 
how to proceed, give a carriage return. If the computer presents you 
with a line of data and then halts (expecting you to correct the line) 
and you do not want to alter it, give a carriage return. If the com- 
puter presents you with a line number followed by a period (asking for 
input) and you do not want to enter data at that line, give a carriage 
return. If the computer asks you to verify a delete instruction which 
you may have given in error (say one which might destroy half of your 
file) and you do not want it executed, give a carriage return. In other 
words, when in doubt, give a carriage return. It is the safe thing to do. 

The period after a line number basically means "I am through. Now 
it's your turn. " If you want the computer to display a line, you type 
the line number and a period before your carriage return. ( A line 
number followed immediately by a carriage return is ignored, the 
carriage return in this case again meaning "No, I didn't mean it. "). 

If the computer prints a line number followed by a period, it is waiting 
for you to fill out the line. The period is therefore used in essentially 
the same way by you and by the computer, except that you must also 
give a carriage return while the computer frequently stops after the 
period and lets you type your response on the same line. 

The program is operated in five main modes: (1) an input mode, 

(2) a sequencing mode, (3) a peek mode, (4) a print mode, and finally, 
(5) a manual command mode. Provisions are made for rapid and con- 
venient switching between these various modes. 

1. Input Mode 

In the input mode, the program generates a series of line numbers 
(with periods), incremented by 10, starting at the end of the existing 
file. This mode may be entered from the manual mode by typing an I 
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followed by a carriage return. It may also be entered from the peek 
mode by this same action. When in the input mode the operator has 
but two choices. He may either type input data to go with the line 
number or give a carriage return without data which causes the pro- 
gram to switch to the manual mode. The input is automatically 
checked for format and for a limited class of programming errors 
(e.g. , in the case of FAP for illegal operation codes and for multi- 
plily defined symbols). Warnings of all such errors are reported 
after receipt of the next following input line. 

2. Sequencing Mode 

In the sequencing mode the program also generates a sequence of line 
numbers (again with periods), but in this case starting at the specified 
line number and incremented by the specified amount. This mode may 
be entered from the manual mode by typing a line number, a comma, 
and an increment number before the carriage return. It may also be 
entered from the peek mode by this same action. When in the sequenc- 
ing mode the user may either type data or leave the mode by giving a 
carriage return without data. Besides warnings of the type noted under 
Input (above) the program also requires operator approval before it 
will over-write existing information. 

3. Peek Mode 

In the peek mode the program types out a line number (with no period) 
followed by the contents of this line. This mode may be entered from 
either the manual mode or the peek mode itself; the user simply types 
a line number with a terminating period (the period always meaning 
"I'm through, now it's your turn") and gives a carriage return. 

When in the peek mode the computer prints the contents of the specified 
line or, if the requested line number is missing, it displays the next 
higher numbered line. The user may then signify that he does not wish 
to alter the line by giving a carriage return, whereupon the program 
automatically prints the next line. Alternatively, the user may correct 
the line by making single character corrections, by making insertions 
or by making deletions as explained below. 

The user has still other options at this point. He may leave the printed 
line as it is and (a) re-initiate the peek mode at some other line, by 
simply typing the desired line number followed by a period and carriage 
return, or (b) initiate sequencing by typing a line number, followed by 
a comma and then followed by the increment number before the carriage 
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return. He may also enter a line of data with any arbitrary line num- 
ber by typing the line number with a single space or tab separating it 
from the data (a line number immediately followed by a carriage re- 
turn is ignored). Finally, the user may issue any one of a number of 
different commands, as explained below under Manual Mode. 

Corrections in the Peek Mode 


After a peek line has appeared, the user may choose any desired non- 
numerical character as a ditto mark including blank (excluding certain 
obvious ones with overriding system significance and, of course, omit- 
ting those characters which are themselves to be inserted). This choice 
of ditto (and it can differ from line to line) is communicated to the pro- 
gram by typing the character 6 times in a row under the line number 
and terminating blank (which are always assumed to be correct). 
Thereafter, this ditto character is typed under each character that is 
to be retained. 

Single character corrections are made simply by interrupting the stream 
of dittos to type the desired correct character under the one to be replaced. 

Deletions are made by typing a left parenthesis ( under the character to 
be deleted (with the obvious mnemonic meaning that the line is to be 
moved to the left with the indicated character deleted). 

Insertions are made by typing a right parenthesis ) under the first good 
character after the break where the insertion is to be made (meaning 
move this character to the right) and then by typing the desired character 
or characters which are to be inserted, terminating the insertion by the 
ditto character. It should be noted that for n insertions, at least n + 2 
good characters must exist in sequence after the insertion since the 
insertion mark and insertion characters act as dittos as far as n + 1 
characters are concerned, and there must be a terminating ditto. This . 
causes no trouble since it is always possible to replace erroneous 
characters one by one by typing in corrected information until a string 
of good characters are encountered or in extreme cases until the end 
of the line. 

It should be noted that the use of parentheses marks as delete and insert 
marks does not prevent one from inserting parentheses in the text; 

) ( means insert left parenthesis, and )) means insert right parenthesis. 
Parentheses cannot, however, be directly substituted for existing 
characters. 
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For many programs the period is a very convenient ditto mark. Ex- 
cept for some slight difficulties with line-up, the space bar (blank 
character) may also be used. This is particularly useful for inserting 
a location symbol (where typing can cease as soon as the location is 
inserted), for single character corrections and for adding comments 
to an otherwise correct line. It should be noted that the carriage re- 
turn automatically filles the rest of the correction line with blanks. 

This arrangement alleviates the need for typing beyond the correction 
point when the blank is used as the ditto. It can also be employed with 
advantage to truncate a line, when using some other character as the 
ditto. 

The tab key should not be used in a correction line. If time can be 
saved by using the tab key, it is only necessary to leave the peek 
mode by retyping the line number followed by the desired data. 

It is also poor practice to use the system backspace and character- 
delete keys in the correction line as this causes the comparison lines 
to get out of step. When errors are made in typing the correction 
line the simplest procedure is to use the line-delete key (to delete 
the correction line) then to type the line number with a period (to ask 
for the line over again) before giving a carriage return. Of course, 
if it is decided that the line was correct after all, it is only necessary 
to type the line -delete character and give a carriage return. 

4. Print Mode 

In the print mode the computer prints the file starting at the beginning 
or at any specified line number. This mode is entered by typing the 
word PRINT (or simply the letter P) which may be followed by the 
desired starting line number separated from the command (or initial) 
by one separating symbol (which may be a blank, a comma, or a period). 
This command may be given when in either the peek mode or in the 
manual mode. Printing may be terminated by a single interrupt signal. 

5. Manual Mode 

In the manual mode the computer types MAN, and awaits instructions. 
This mode may be entered from the input and sequence modes by a 
carriage return. When in the manual mode the user may enter (a) the 
input mode by typing an I, (b) the sequencing mode by typing the line 
number and interval separated by a comma, (c) the peek mode by 
typing a line number only followed by a period, or (d) the print mode 
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by typing PRINT (or the initial P) followed by the starting line number, 
all of these followed by a carriage return. The user may also file a 
line with any desired line number by simply typing the line number, 
followed by a space (or tab) then the data and a carriage return. 
Finally, he may issue any one of a number of other commands. 

Commands in the Manual and Peek Modes 

Commands may be given either by initial only (with the exception of 
delete) or by name. They may be given with or without associated 
data which may be separated from the command by a space, a comma, 
or a period (in accordance with the whims of the user). When given 
by name, the commands may even be misspelled, but only to the extent 
that there can be no ambiguity. 

The existing commands are: 


Initial 

Name 

Associated 

Data 

Explanation 

B 

Be brief 

as 

Omit verification after a cor- 

C 

COMBINE 

a, b, n 

rection in the peek mode, and 
execute deletions and overwrite 
requests without question, 
(expanded) 

Combine/ file a, b with the file 


being edited by inserting it after 
line n of the file being edited. 

The inserted lines will be renum- 
bered if necessary to preserve 
order and a portion of the file 
from this point onward will also 
be renumbered if necessary. If 
a and b are pure numerics then 
lines a through b of the file being 
edited will be duplicated and in- 
serted after line n, again with any 
necessary renumbering. 

Delete lines m through n. The 
omission of n results in a single 
deletion. The omission of both m 
and n or the use of an n smaller 
than m causes the command to be 
ignored. 
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(not allowed) DELETE m, n 



Initial 

Name 

Associated 

Data 

Explanation 

D 

DITTO 

■ m 

Duplicate the line just displayed 
in the peek mode for correction 
and filing as line m. 

E 

EXPAND 

a, b 

Recombine the split files into a 
new expanded file by name a b. 

F 

FILE 

a, b 

Recombine the split files into a 
new compressed file by name a b. 

If no name is given, the initial name 
is used. 

I 

INPUT 

m 

Enter the input mode using the num- 
ber m as the increment (in place of 

10). Leaving the input mode will 
automatically restore 10 as the 
normal increment. 

L 

LOCATE 

S 

Locate the line number correspond- 
ing to the symbolic location S. 

N 

NUMBER 

m, n, a, b 

Renumber, starting with the number m 
and incrementing by n, and file in com- 
pressed form as a, b. If no m, start 
with 10. If no n, increment by 10. If 
no a, b, use original name. 

P 

PRINT 

m 

Print the file being edited beginning 
with line m. If no m is given, start 
printing with the first line. 

R 

RESUME 

a, b 

Save files now being edited in split 
form and resume editing of file a b 
which may be in compressed form or 
already split. 

S 

SAVE 


Save current files in their split form 
for subsequent editing. 

T 

TABLE 


Alphabetize and print the symbol table. 
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Initial 

Associated 
Name Data 

Explanation 

V 

VERIFY 

Reprint the corrected line for 
verification after each correction 
when in the peek mode; also 
question attempts to overwrite 
when in sequencing mode. 




Massachusetts Institute of Technology 
Project MAC 


A. L. Samuel 


ADDENDUM to Memorandum MAC-M-167 October 29, 1964 

A new version of CTEST9 is now in the system. All known bugs have been 
removed, and the program has been made more effecient. 

Also, the following alterations affect FAP programmers: 

a) A symbol table is no longer kept. Thus the commands LOCATE and 
TABLE are not available. 

b) The brief mode, in addition to all of its previous functions, 
now suppresses the checking of FAP op codes, and thus enables the 
user to input MACROS. 

ADDENDUM to Memorandum MAC-M-167 of 6 January 1965 

The following changes have been made in CTEST9 and are of interest 
to MADTRN and DYNAMO users: 

a) The restriction that statement number be numerical has 
been removed, since MADTRN will work for Alpha-numeric statement 
labels, unlike most FORTRAN compilers. Statement labels are still 
automatically right- justified in columns 1-5. 

b) To accommodate DYNAMO users, the command B (for BRIEF) given, 
while inputting or editing a MADTRN file will suppress all errors 
comments and field justifications which would cause a legal DYNAMO 
to be rejected or filed incorrectly. In other words legal DYNAMO 
lines may be created in the BRIEF mode. A "tab" among the first 
six characters will cause the desired indentation to column 7. The 
user is cautioned to issue the BRIEF command before input of the 
first line in a DYNAMO file. 

A MADTRN statement will be correctly filed, but most error comments 
and the right justification of the statement label field will be 
suppressed . 

Please direct all inquiries comments, and criticisms of CTEST9 to 
I. M. Norton, Room 812 Tech. Square, ext. 5867 



This new edit command is now being operated as a special 
command called for by typing ,, CTEST9". 

Warning: users of the older version are cautioned that 
the file and renumber commands now produce compacted files with a 
great reduction in disk space, but these compacted files can not 
be split, combined or compiled without expansion.. The command "E" 


takes care of this. 



